home *** CD-ROM | disk | FTP | other *** search
/ MacFormat 1995 July / macformat-026.iso / mac / Shareware City / Graphics / QuickSnap092 / Users Guide < prev   
Encoding:
Text File  |  1995-03-28  |  8.6 KB  |  97 lines  |  [TEXT/ttxt]

  1. QuickSnap
  2.  
  3. Users Guide
  4.  
  5. Version 0.9.2 Copyright © Tim Molteno & Perspicuity Inc, 1995. All rights reserved
  6.  
  7. Introduction
  8.  
  9. QuickSnap is an application designed to work with the Connectix QuickCam. It is an improvement over the QuickPICT application supplied with your QuickCam, as it allows you to save photographs in JPEG format. Additionally QuickPhoto has an automatic exposure feature and a spot-meter which allows you to work efficiently in conditions where the light level is not constant.
  10.  
  11. QuickSnap is currently a BETA release. It is shareware © Tim Molteno & Perspicuity Inc. 1994-95. The shareware fee is US$25 and for this you will get a nice letter, the latest version and a licence to download future updates. Oh yeah, you'll get a special code which customises your application so your name appears in lights whenever the program starts up. In addition when you register, you get access to extra features. In this version thats the JPEG comment feature which lets you add comments to JPEG files. In future versions the same registration code will give you even more features.
  12.  
  13. Contact me with suggestions by email (tim@physics.otago.ac.nz) or preferably via my www site which will contain future updates and other special features  (http://newton.otago.ac.nz:808/timdocs/timpage.html) or...
  14. Perspicuity Inc.
  15. P.O. Box 1220
  16. Princeton, NJ 08542-1220
  17. U.S.A.
  18.  
  19.  
  20. QuickSnap Description
  21.  
  22. QuickSnap has two main windows, the Viewfinder window and the Info window. The Viewfinder is just that. It contains the current view of the camera. Additionally, if you take a photo then a window will appear containing that photo. You can choose to discard photos you take or you can save them in a variety of formats.
  23.  
  24. The info window floats around the desktop filled with useful info. Please email me any suggestions on further info needed here. It contains the currrent brightness averaged over the spot meter (see below). The current exposure time in milliseconds and the number of bytes per frame. Play with the compression settings (Video menu) and see how this number varies with different compressors. This is an upper limit on the size of images. The lossless algorithms like JPEG usually produce an image much smaller than this. This means that the actual image file sizes are far smaller that this value. I find for the QuickCam images that the final JPEG image is 5 times smaller than the maximum shown in the info window.
  25.                                                                                                         _____________________________
  26.  
  27.  
  28. Taking Photo's with QuickSnap
  29.  
  30. To take a photo with QuickSnap, simply plug in your QuickCam and make sure the camera is operating correctly. Then follow the following simple instructions
  31. •  Run QuickSnap and you should see the object of interest (whatever the Camera is pointing at) in the Viewfinder window. Superimposed over the image is a rectangle. This is the spot meter used to control the exposure of the camera.
  32. • Choose 'take photo' N from the File menu. A photo window will appear containing the image you have just taken.
  33. • Choose 'save' or 'close' from the File menu. The photo will be saved in JPEG format and you will be prompted for the filename.
  34.  
  35. New Photo N
  36.  
  37. This takes a still image of what is in the viewfinder. This image is places in a window. If you wish to save this window, select the window and choose 'save' from the file menu. IF you choose 'close' from the file menu, the window is closed and if the contents are not saved then they are lost.
  38.  
  39. Copy Photo 
  40.  
  41. You can select a window, either the viewfinder of a photo window and copy it to the desk scrap. You may then paste this photo into other applications.
  42.  
  43. Exposure Control
  44.  
  45. In the Set Exposure menu option there are two parameters which can be set.  The first is the desired brightness, specified in percent. One hundred percent means that the average value of the pixels in the spot meter is saturated (i.e., white/ slow exposure time) and zero percent means the pixels being black (fast exposure time). You probably will not want to change  this value outside the range 40-60 %. QuickPhoto uses a simple algorithm to adjust the exposure time of the QuickCam in such a way as to make the brightness inside the spot meter (see below) is close to the desired brightness. The default value for this parameter is 50%.
  46.  
  47. The second parameter which can be set from the 'Set Exposure' menu option, is the shutter delay. This is the number of seconds which QuickPhoto will wait (after the 'Take Photo' command is issued) before taking the photo. The default setting here is zero, meaning that the photo is taken immediately.
  48.  
  49. Spot Meter
  50.  
  51. The spot meter is a rectangle that you define in the video window. This rectange defines the are over which the automatic exposure is controlled. For example if the rectange is a small square, then QuickSnap checks to contents of that square and adjusts the exposure so that the contents of that square have an average brightness equal to that specified in the exposure dialog.
  52.  
  53. The rectangle you define must be a multiple of eleven pixels high and wide. To precisely position this rectangle it is best to click on the top left corner first and then drag (holding the mouse button down)  to the bottom right corner. Try doing it the other way to see why. This shouldnt be a problem unless your spt rectangle is miniscule. Something I don't recomment as then the brightness of the backgroun can appear to fluctuate dramatically as the light intensity varies inside the spot meter rectangle.
  54.  
  55. Add Comments
  56.  
  57. Choosing this menu option will pop up a dialog which allows you to add text comments to your JPEG files. This cute feature is useful as you can effectively add captions to your JPEG images. To use this you will have to register your program ! This can be done by sending in your shareware fee (preferably by email) and you will receive a code which, typed into the registration box, will customize QuickSnap and provide these features.
  58.  
  59. Compression
  60.  
  61. The compression menu item (Photo Menu) pops up a standard dialog which allows the user to set the compression type for their photo.  The default is JPEG and the output is then a JPEG standard still image. If one chooses NONE for the compression then the output is a raw binary (4 bits per pixel) dump of the camera image. Other compression formats are not supported at the moment. Email me with requests for additional formats. PICT's will be added shortly, note that PICT's are written to the scrapbook in this version.
  62.  
  63.  
  64.                                                                                                         _____________________________
  65.  
  66.  
  67. Making Time-lapse Movies
  68.  
  69. A time lapse movie is one where a single frame is taken at fixed time intervals, usually of more than a second. This means that when the movie is played back, the subject of the movie appears to speed up. So if you take one thousand frames at ten second intervals, then play them back at ten frames per second, time in the movie will appear to have sped up by a factor of one hundred. Clouds speed across the sky, flowers burst open in seconds instead of hours. This is a MUST DO feature of QuickSnap. Make Time lapse movies and impress your friends.
  70. To make a time lapse movie with QuickSnap, simply plug in your QuickCam and make sure the camera is operating correctly. The exposure control is achieved using the Photo menu controls. Just like when you're taking still images.
  71.  
  72. Record Movie
  73.  
  74. This begins recording a movie. Your powerbook will not be able to sleep during the taking of the movie. You will be prompted for a movie file name at this point.
  75.  
  76. Stop Recording
  77.  
  78. This halts the recording of the movie.
  79.  
  80. Time Lapse Setup
  81.  
  82. This specifies the time interval in seconds between frames in the time lapse movie. This can be specified in fractions of a second. Note that the timing is not incredibly accurate due to hard disk accesses e.t.c.
  83.  
  84. Compression
  85.  
  86. The compression menu item (Video Menu) pops up a standard dialog which allows the user to set the compression type for time-lapse movies.  The default is ANIMATION ('rle ') compression, this allows for fast decompression and with greyscale images gives a good compression ratio. If one chooses NONE for the compression then the output is a raw binary (4 bits per pixel) dump of the camera image. All the compression formats are supported. I suggest you stick to animation compression for small frame sizes (less than 240 x 180) and the xxxxxxxx for larger frame sizes.
  87.  
  88.                                                                                                         _____________________________
  89.  
  90. KNOWN BUGS & FEATURES TO COME
  91.  
  92. • Will allow the user to save the image in a QuickTime PICT 2 format.
  93. • Will write the estimated JPEG image size to the info window.
  94. • Scriptability will be added (when the project is converted to C++)
  95. • Drag & Drop support.
  96. • Motion detection algorithms for security applications !
  97.